Version Changelog
Here is a list of updates and fixes.
** Version 1.1.11 **
- Fix: fix functions missing bug
** Version 1.1.10 **
- Fix: Loging mysql date instead of current wordpress date for auction history
- Fix: Bug in loop pay now button
+ Add: Option to filter auctions from product search page
+ Add: Auction search widget
+ Add: Auction activity page
** Version 1.1.9 **
- Fix: Pay auction link issue (important fix!)
- Fix: Product Quantity, plus and minus signs not showing / working
** Version 1.1.8 **
- Fix: Problem with sending mail on different language
- Fix: Problem with cronjob
** Version 1.1.7 **
- Fix: Problem with sending mail on Woocommerce > v2.3.x
** Version 1.1.6 **
- Fix: Problem with stock when saving post
- Add: Shortcode for ending soon auctions
** Version 1.1.5 **
- Fix: Problem with showing auction finish email template
** Version 1.1.4 **
- Fix: Filtering auctions from pages
- Fix: My auction shortcode and widget bug
** Version 1.1.3 **
- Fix: wait interval days to send reminder to pay mail
- Fix: small typos
- Fix: counter message when auction has started
- Add: added no-products-found template for shortcodes
** Version 1.1.2 **
- Fix: Spelling errors
- Fix: Bugs with WPML
** Version 1.1.1 **
- Fix: Live checks bug for non logged user
** Version 1.1.0 **
- Add: Live checks on auction bids
- Add: Showing current max bidder to admin and to current max bid user
- Add: WordPress 4.0 and WooCommerce 2.2 ready
- Fix: files cleanup
** Version 1.0.25 **
- Fix: Send reminders mail cron bug
** Version 1.0.24 **
- Fix: turn off proxy bidding bug
- Fix: WPML compatibility
- Fix: showing mutiple products bug
** Version 1.0.23 **
- Fix: Problems with currency symbol positioning
- Fix: Problems with virtual and download checkboxes
** Version 1.0.22 **
- Add: Turn on / off admin email notification for every bid placed by user(s)
** Version 1.0.21 **
- Fix: Proxy auction bug
** Version 1.0.20 **
- Add: Hook woocommerce_product_options_auction
** Version 1.0.19 **
- Add: Filter auction in backend
** Version 1.0.18 **
- Fix: Problem with cronjob
** Version 1.0.17 **
- Fix: Problem activating on a multi-site installation of WordPress
** Version 1.0.16 **
- Fix: Problem with out of stock bug
** Version 1.0.15 **
- Fix: Problem with filtering date timezone
** Version 1.0.14 **
- Add: Filter for item condition (simple_auction_item_condition)
- Fix: Format date with wordpress settings
** Version 1.0.13 **
- Fix: Language typo
- Fix: Optimizing query
- Fix: html number element
** Version 1.0.12 **
- Fix: Problem same max bid in proxy mode
** Version 1.0.11 **
- Fix: Problem with decimal bidding
** Version 1.0.10 **
- Fix: Problem with proxy bidding setting max price
** Version 1.0.9 **
- Fix: Problem with loading languages files
** Version 1.0.8 **
- Fix: Problem with price on regular products
** Version 1.0.7 **
- Add: Send mail to admin when auction is finished
** Version 1.0.6 **
- Add: Do not show auctions on product category page option
- Add: Do not show auctions on product tag page option
- Fix: email templates path
** Version 1.0.5 **
- Fix: starting bid bug
- Fix: product copying bug
** Version 1.0.4 **
- Add: manually delete any bid
** Version 1.0.3 **
- Fix: problem with checkout
- Fix: problem with table prefix
- Fix: problems with reserve price
- Fix: displaying timezone in UTC format
- Fix: language (thanx to artsmart)
** Version 1.0.2 **
- Fix: saving decimal bid to log
- Fix: problems with translations
** Version 1.0.1 **
- Add: support for woocommerce > 2.1
- Fix: couple minor bugs
** Version 1.0.0 **
- Initial release
WooCommerce Simple Auctions
WooCommerce Simple Auctions is a plugin for a plugin :) Since WooCommerce is popular we decided that it would be neat to extend it with auction features. We wanted to make it easy to use but also to include all auction features so you get a powerful auction solution which is easily setup and customized.
With our auction plugin you can setup WordPress auction website and start auctions in less than 30 minutes (assuming you have payment processor account ready). Plugin integrates seamlessly with WooCommerce and no special knowledge is needed (same level like for standard WooCommerce usage).
Overview and Features
- Seamless integration into WooCommerce via its hooks
- You get new type of WooCommerce product type - auction
- Normal or reverse auctions
- Proxy / auto bidding (learn more about auto bidding here)
- Define start price, price increment, reserve price, buy it now price
- Set start and end time for auction
- Easily control how you want to display auctions - along with other items or on separate page
- Widgets with ending soon, latest, featured, recently viewed, my auctions and random auctions
- Email notifications (with editable email templates) for won auction, failed auction, pay for won auction notification, outbid notification, reserve not met fail, auction sold for buy now price notification
- Auction product has auction icon (label) on thumbnail
- If user is logged in and winning in auction, auction item has winning badge on thumbnail
- Product single page has new tab "Auction History"
- User has "My auctions" option where auctions in which user placed a bid are listed (for both active and won auctions)
- Auction filtering in product list (wp-admin)
- Auction product has icon which describes different auction status: active, finished, finished and paid, failed (wp-admin)
- Shortcode to show my auctions for logged in user
- Make auction from virtual or downloadable products
- Manually delete any bid
- WPML compatible
- Easily get 99/100 speed rank score
Installation
Make sure to install WooCommerce before you activate WooCommerce Simple Auctions plugin.
You can install plugin via WordPress "Add New" plugin - to do that download zip with plugin only, click add new and that's it. In case you do not have permissions to upload to plugins/ directory you will need FTP login info.
Alternative setup. After downloading WooCommerce Simple Auctions plugin, extract plugin zip and upload it to your plugins directory - wp-content/plugins/ folder of your Wordpress installation. Since this is extension for WooCommerce you need to install WooCommerce before activating the plugin. WooCommerce plugin which can be downloaded here.
If you need help installing Wordpress see the link here: http://codex.wordpress.org/Installing_WordPress
Once you installed and activated WooCommerce go to WooCommerce > System Status and make sure that you don't have red colored errors (specially for WP memory limit).
WooCommerce Simple Auctions plugin uses cronjobs and you have to setup two cronjobs:
- once a day: /usr/local/bin/curl --silent http://www.your-domain.com/?auction-cron=mails
- every minute: /usr/local/bin/curl --silent http://www.your-domain.com/?auction-cron=check
Here is screenshot of cronjobs page and setup in DirectAdmin control panel
More details about cronjobs can be found here. If you don't know how to add cronjob the best and the easiest way is to email your hosting support to do it for you. Or you can be brave and Google "add cronjob + name of your web hosting control panel" and DIY. Or you can contact us if everything else fails :)
Install Sample Data:
WooCommerce comes with sample data which you can import, dummy data file is /wp-content/plugins/woocommerce/dummy_data.xml Steps to import demo data to your WordPress WooCommerce site:
- Go to Tools > Import
- Select XML dummy content file from /wp-content/plugins/woocommerce/dummy_data.xml
- Click Upload file and import
- Assign posts to an exitsting account
- Check Download and import file attachments
- Click Submit and wait until WordPress finish downloading attachments and importing content
Importing dummy data can take some time, specially on slow Internet connections. Be patient and do not close or refresh browser tab until import operation is completed.
Quick Auction Setup
Setting up new auctin is easy:
- make sure all steps from Installation are done (WooCommerce installed, plugin enabled, cronjobs set)
- go to Products => Add Product
- add title, description, images, featured image, select category - all things you do when adding regular product
- in Product Data dropdown menu select Auction
- you will see new tab in left menu named Auction, see screenshot:
- fill all details (they are self explainable)
- set auction duration by setting start and end date
- publish product (auction)
When you refresh your home page you should see new product with auction badge.
Advanced usage usually means setting up proxy bidding (auto bidding) and reverse auctions (for example you post a coding project and want to get lowest possible price for it).
Changes in WooCommerce
After you activate WooCommerce Simple Auctions plugin couple new options will appear:
- WooCommerce product has new tab in Product data block called Auction
- Product list has column with auction status icons
- Product list filter has auction filtering
- Single product page in wp-admin has new block named "Auction" where you can see auction history and number of different email notifications sent
- Orders list has column with auction icon to easily see which order is from auction
- WooCommerce settings have new tab called Auctions
- WooCommerce email settings have new items: outbid note, auction won, payment reminder, auction failed, reserve failed and auction buy now
- New widgets: ending soon auctions, featured auctions, latest auctions, recently viewed auctions, my auctions, random auctions
- New shortcodes
Auctions listed along WooCommerce products on home page:
New WooCommerce product type auction:
Plugin options
Here are settings that you can turn on and off. Settings are self explainable. You can enable or disable showing past and future auctions. Another useful setting is whether to mix regular products with auctions or just show auctions on separate page (defined via Auctions Base Page dropdown, see screenshot).
On screenshot below you can see how product list with auctions looks like. Auction status icons are explained on the screenshot.
On screenshot below you can see how to enable live ajax updating of current bid price (feature introduced in version 1.1.x). To minize number of requests, ajax request is done only if you have bid tab in focus otherwise ajax is not running. This is done like this to make it easy on server and hosting resources.
Once auction is closed (or finished) there is no way to reactivate auction. Only way to reactivate an auction is to create new one with same details.
Shortcodes
Here is a list of all available plugin shortcodes. Some shortcodes accept optional orderby and order attributes.
- show ending soon auctions -
[ending_soon_auctions per_page="12" columns="4" order="desc"] - show recent auctions -
[recent_auctions per_page="12" columns="4" orderby="date" order="desc"] - show featured auctions -
[featured_auctions per_page="12" columns="4" orderby="date" order="desc"] - show auctions with specific product ID -
[auctions ids="1,2,3,4,5"] - show auctions with specific SKU code -
[auctions skus="foo, bar, baz" orderby="date" order="desc"] - show user's auctions -
[woocommerce_simple_auctions_my_auctions]
FAQ
Here you can find answers to frequently asked questions. Feel free to contact us if you can't find answer to your question.
-
Do you have list of hooks? - Yes, list is below:
- woocommerce_simple_auctions_before_place_bid
- woocommerce_simple_auctions_outbid
- woocommerce_simple_auctions_place_bid
- woocommerce_product_options_auction
- woocommerce_simple_auction_pay_reminder
- woocommerce_simple_auction_close_buynow
- woocommerce_simple_auction_delete_bid
- woocommerce_simple_auction_close
- woocommerce_simple_auction_fail
- woocommerce_simple_auction_reserve_fail
- woocommerce_simple_auction_won
<?php add_action( 'woocommerce_simple_auctions_before_place_bid, 'custom_function' ); ?>
- I have issue with number element in Firefox 29 (input where you enter your bid)? - This usually is theme issue and should be resovled via theme
modifications. Easiest way to sort it is via CSS modification:
div.quantity input[type=number].qty { -moz-appearance:textfield; } - How to use simple_auction_item_condition filter? - In functions.php add:
add_filter('simple_auction_item_condition', 'my_example_filter_1' ); function my_example_filter_1( $array ){ $array['old']='Old'; return $array; }and in product data you will get new product condition option available to select named "Old". - How to increase bid step for bid increment value to be more than 1? Bidding increment is done so you can bid in increments of 1, because otherwise if you set bid step of say 5, you would be able to bid 5, 10, 15...
instead you can bid 7, 13, 22, etc. If you insist on different behaviour, you need to edit templates\single-product\bid.php and change:
step="any" becomes step="<?php echo ($product->auction_bid_increment) ? $product->auction_bid_increment : '1' ?>"
- Can I delete fake bid? - Yes, go to item details, section Auction where auction log is and click on delete.
- Can users create their own auctions like on eBay? - Basically yes, only users who can add new products can create auctions. You can use multiple vendor plugin which will allow you to add users who will be able to create products (auctions). Check multiple vendor tutorial here.
- Do you use cronjobs? - Yes. Please check installation instructions.
- Where can I edit email templates? - Go to WooCommerce > Settings and click on Emails tab.
- Does this plugin work with caching plugins? - Yes, W3TC is working but we advise no caching for logged in users. For example if page cache is enabled widget will not work - recently viewed auctions. Once user is logged in and there is no caching anymore all widgets will work. You can use CDN and browser caching. Our plugin demo website uses W3TC with page and object caching, browser caching and generic CDN mirroring.
- What is auto bidding / proxy bidding? - Ebay has nice explanation here.
- What is reserve price? - A reserve price is the lowest price at which you are willing to sell your item. If you do not want to sell your item below a certain price, you can a set a reserve price. The amount of your reserve price is not disclosed to your bidders, but they will see that your auction has a reserve price and whether or not the reserve has been met. If a bidder does not meet that price, you are not obligated to sell your item.
- I want auction end timer everywhere, what should I do? - Add this code to functions.php:
add_action( 'woocommerce_after_shop_loop_item_title','wpgenie_show_counter_in_loop',50 ); function wpgenie_show_counter_in_loop(){ global $product; $time = ''; if(!isset ($product)) return; if('auction' != $product->product_type) return; $timetext = __('Time left', 'wc_simple_auctions'); if(!$product->is_started()){ $timetext = __('Starting in', 'wc_simple_auctions'); $counter_time = $product->get_seconds_to_auction(); } else{ $counter_time = $product->get_seconds_remaining(); } $time = '<span class="time-left">'.$timetext.'</span> <div class="auction-time-countdown" data-time="'.$counter_time.'" data-auctionid="'.$product->id.'" data-format="'.get_option( 'simple_auctions_countdown_format' ).'"></div>'; if($product->is_closed()){ $time = '<span class="has-finished">'.__('Auction finished','wc_simple_auctions').'</span>'; } echo $time; } - I want to increase time auction is extended after bid is placed? -
In function.php you need to add code below (this particular code extends auction for 30 sec - note PT30S):
add_action( 'woocommerce_simple_auctions_outbid', 'woocommerce_simple_auctions_extend_time', 50 ); function woocommerce_simple_auctions_extend_time($data){ $product = get_product( $data['product_id'] ); if ('auction' === $product->product_type ){ $date1 = new DateTime($product->auction_dates_to); $date1->add(new DateInterval('PT30S')); update_post_meta( $data['product_id'], '_auction_dates_to', $date1->format('Y-m-d H:i:s') ); } } -
I want to extended auction finish time after a bid is placed so that it only extends the auction if a bid is placed when the auction is within 5 min of closing? -
/* Auto Extend Auction by 2 min when a bid is placed within the last 5mins */
add_action( 'woocommerce_simple_auctions_outbid', 'woocommerce_simple_auctions_extend_time', 50 ); function woocommerce_simple_auctions_extend_time($data) { $product = get_product( $data['product_id'] ); if ('auction' === $product->product_type ) { $auctionend = new DateTime($product->auction_dates_to); $auctionendformat = $auctionend->format('Y-m-d H:i:s'); $time = current_time( 'timestamp' ); $timeplus5 = date('Y-m-d H:i:s', strtotime('+5 minutes', $time)); if ($timeplus5 > $auctionendformat) { $auctionend->add(new DateInterval('PT120S')); update_post_meta( $data['product_id'], '_auction_dates_to', $auctionend->format('Y-m-d H:i:s') ); } } } - Bidder beat another bidder with same amount? - When Proxy Bidding is in effect, it can appear as if one bidder has beat another bidder with the same bid amount. This is normal and occurs when a bidder has a proxy bid in effect and a second bidder comes along and makes their bid at the exact same amount the current proxy bid is at. Since the proxy bid was placed earlier, that is the bid that will succeed. For the second bidder to succeed in placing a bid, they must bid higher than the proxy bid that is in effect.
- How can I show only finished auctions? - You need custom page template with custom query:
$args = array( 'post_type' => 'product', 'show_past_auctions' => TRUE, 'tax_query' => array(array('taxonomy' => 'product_type' , 'field' => 'slug', 'terms' => 'auction')), 'meta_query' => array( array( 'key' => '_auction_closed', 'value' => '2', ) ) ); $the_query = new WP_Query( $args ); - Can I make theme with WooCommerce Simple Auctions and sell it on ThemeForest? - Sure, just purchase extended licence and you're good to go.
Since the current licenses do not deal with re-selling Items, Envato lets authors to decide whether they grant permission for bundling Items or not. We have the following conditions, and you need to follow them:
- You cannot redistribute the item "as-is", even if you modify it or you make a derivative version for another platform
- You cannot offer the plugin as a stand-alone item
- You cannot include the plugin separately from your theme in the download package
- You cannot provide an Item Purchase Code for your customers - Since Envato doesn't have a "multi-use" or transferable license, your customers are not entitled to receive an Item Purchase Code with your theme and use the plugin separately from your work.
- Updating the plugin is your own responsibility
- Since your customers cannot receive updates from us, you need to handle this on your own
- You need to handle related support requests after your customers or you can instruct them to buy regular licence and ask us for support directly via our CodeCanyon profile (we cannot provide free support for your customers)
- I can't do anything because I get "out of stock message"? - Simple Auctions plugin needs inventory / stock to be enabled. If you have problems all issues should be fixed by upgrading to Woocommerce Simple Auctions v1.1.6
- I want to enable users to bid even if they are allready highest bidder? - In /woocommerce-simple-auctions/classes/class-wc-bid.php comment out lines 106-114
/*if ($current_user -> ID == $product_data -> auction_current_bider) { if (version_compare($woocommerce->version, '2.1', ">=")){ wc_add_notice(sprintf(__('No need to bid. Your bid is winning! ', 'wc_simple_auctions'), $product_data -> get_title())); } else { $woocommerce -> add_message(sprintf(__('No need to bid. Your bid is winning! ', 'wc_simple_auctions'), $product_data -> get_title())); } return false; }*/